home *** CD-ROM | disk | FTP | other *** search
/ EuroCD 3 / EuroCD 3.iso / MIDI / Utilities / CS1x-Ed / Midilib / readme
Text File  |  1998-06-24  |  8KB  |  257 lines
  1. MIDI LIBRARY DISK
  2. =================
  3.  
  4. v2.0 - 12-Nov-88
  5.  
  6. This is the MIDI Library distribution disk.  It contains the MIDI
  7. Library, utilities, user and programmer documentation, and example
  8. programs.
  9.  
  10. For those new to the MIDI Library, I suggest looking in the "docs"
  11. directory first.  Depending on your preference, you may wish to examine
  12. "library.doc" which describes the fundamental concepts behind the MIDI
  13. Library, or "utils.doc" which describes the included set of CLI based
  14. MIDI Utilities.
  15.  
  16.  
  17. Revisions
  18. ---------
  19.     v2.0 - 12-Nov-88
  20.     . midi.library
  21.         . Major overhaul to improve speed - resulting in about 3 to 4
  22.           times improvement in speed for PutMidiMsg, PutMidiStream,
  23.           GetMidiMsg, FreeMidiMsg
  24.         . Added MidiPacket's (see GetMidiPacket() and
  25.           FreeMidiPacket())
  26.         . Rewrote all C modules in Assembly
  27.         . Redesigned PutMidiStream
  28.         . Added early test of Route MsgFlags to reduce processing
  29.           time on trivial messages
  30.         . Added default RouteInfo to MDest's (see
  31.           SetDefaultMRouteInfo(), and routing functions)
  32.         . Added MListSignal's to inform interested parties of
  33.           changes to the public node lists (see CreateMListSignal()
  34.           and DeleteMListSignal())
  35.         . Fixed MidiMsgType() to work as originally described: now
  36.           returns 0 on all undefined messages
  37.     . docs
  38.         . revised library.doc to include MidiPackets
  39.         . remade midi.doc to include new functions
  40.         . added benchmark.doc
  41.     . updated binding libraries to include new functions
  42.     . include files
  43.         . added new sys/ex id's from MIDI 1.0 Spec v4.0
  44.         . added new controllers #'s from MIDI 1.0 Spec v4.0
  45.         . added MTC qtr frame message constants
  46.         . added midifile.h for some MIDI File constants
  47.     . rsx
  48.         . manufacturer id is now specified in hex rather than
  49.           decimal
  50.         . now supports filtering for 3-byte manufacturer ID's
  51.     . tsx
  52.         . Workbench support
  53.     . new utilities: playmf & dmf to play and display (respectively)
  54.       MIDI Files
  55.  
  56.     v1.5d - 14-Sep-88
  57.     . minor changes to midi.h & midi.i
  58.  
  59.     v1.5c - 15-Jun-88
  60.     . Fixed bugs in "rsx"
  61.     . Fixed bugs in "ychk"
  62.  
  63.     v1.5b - 29-May-88
  64.     . Aztec libraries have now been created using v3.6a (were
  65.       previously created using v3.4)
  66.  
  67.     v1.5a - 16-May-88
  68.     . Located some inconsistencies in midi.[h|i] that have now been
  69.       fixed.
  70.     . Added Iota sys/ex id (00-0008) to midi.[h|i].
  71.     . Changed MID_EXTENSION to MID_XAMERICA in midi.[h|i]
  72.     . Changed implementation of 3 byte id's in midi.[h|i]
  73.         . now are long ints with all 24 bits of id
  74.         . use macros (MAKE_MIDX() and SPLIT_MIDX()) to deal w/ converting
  75.         discrete bytes to 3 byte ids
  76.     . Added 3 byte sys/ex id support to mm.
  77.  
  78.     v1.5 - 22-Apr-88
  79.     . A bug in the CtrlMatch system that was previously unnoticed
  80.       has been fixed
  81.     . The function of the RIMatch.flags (formerly .count) has been
  82.       changed to allow negating the inclusion logic and to filter 3
  83.       byte manufacturer id's
  84.     . AmigaBasic programming examples from Jim McConkey are now
  85.       included
  86.  
  87.     v1.4 - 04-Apr-88
  88.     . The utilities in c directory now generally use arp.library for
  89.       various things.  Because of this, arp.library v1.1 is included
  90.       in the libs directory just in case you don't already have it.
  91.       (NOTE: for size reasons it is not included in the ARC file)
  92.     . MidiIn & MidiOut task priorities have been increased to +30 to
  93.       avoid interference from input.device.  (You can rearrange windows
  94.       now without slowing down MIDI transfer to/from these nodes
  95.       assuming your own task priorities are around +25)
  96.     . new utility: ychk - checks Yamaha bulk dump files for errors.
  97.       (see doc/utils.doc)
  98.     . some utilities have been enhanced (see doc/utils.doc)
  99.  
  100.     v1.3 - 25-Jan-88
  101.     . Added Reset Controller mode message (Bn 79 00)
  102.  
  103.     v1.2a - 29-Dec-87
  104.     . Modified midi.h & midi.i to include new stuff (noted w/ IMA
  105.       Bulletin references).
  106.  
  107.     v1.2 - 29-Nov-87
  108.     . First disk-based release.
  109.     . Added MTC Qtr Frame message support (F1)
  110.     . Added Lock/UnlockMRoutes() & FlushMDest()
  111.  
  112.     v1.1
  113.     . Initial .arc file release.
  114.  
  115.  
  116. Contents
  117. --------
  118.  
  119.     basic - AmigaBasic programming examples provided by Jim McConkey.
  120.         See basic/readme for more info on these files.
  121.  
  122.     c - contains some CLI-based utilities that use the MIDI Library.
  123.     See utils.doc in the docs directory for more info on these.
  124.  
  125.     docs - documentation
  126.  
  127.         bind.doc - Usage documenation for bind and zlib (included in
  128.                the fd directory).
  129.  
  130.         library.doc - Programmers reference to the MIDI Library.  It
  131.               describes in detail proper usage of the
  132.               Library.
  133.  
  134.         midi.doc - MIDI Library function "autodoc".  It contains
  135.                a description of each MIDI Library function.
  136.  
  137.         utils.doc - Describes the MIDI Utilities in the c directory.
  138.  
  139.     examples - Programming examples.  Contains C source code for sample
  140.            programs that use MIDI Library.
  141.  
  142.     fd - contains a .fd file, binding libraries and a binding maker.
  143.      The binding libraries are used to link your programs to the
  144.      MIDI Library functions.  By their very nature, binding routines
  145.      are compiler specific.  Included are libraries for both Lattice
  146.      and Aztec C.
  147.  
  148.         bind - The binding builder.  There is more info on bind in
  149.            bind.doc in the docs directory.  In general, though,
  150.            you should be able to make bindings for any compiler
  151.            by using bind.
  152.  
  153.         bindfile - A file used by bind.
  154.  
  155.         makefile - a makefile for the included binding libraries.
  156.                It gives you sample usage of the bind program.
  157.  
  158.         midi-lattice.lib - Lattice C compatible bindings library.
  159.                    It should work with Alink or Blink.
  160.  
  161.         midi.lib - An Aztec C compatible bindings library for small
  162.                code/data model.
  163.  
  164.         midil.lib - An Aztec C compatible bindings library for large
  165.             code/data model.
  166.  
  167.         midi_lib.fd - The .FD file for the MIDI LIbrary.  You should
  168.               be able to use this to allow access to the
  169.               MIDI Library from AmigaBasic.  Also this file
  170.               is read by bind to create bindings libraries.
  171.  
  172.         zlib - A simple Amiga object module librarian.  See bind.doc
  173.            for more info on this.  (Arp v1.1 Join can handle the
  174.            job now, feel free to use it instead of zlib)
  175.  
  176.     include.h - C Language include files.
  177.  
  178.         midi/midi.h - contains the structure definitions for normal
  179.               usage of the MIDI library and constants
  180.               defined for MIDI status bytes, controllers,
  181.               etc.
  182.  
  183.         midi/midibase.h - defines structures used when examining the
  184.                   inner workings of the MIDI library. This
  185.                   need not be included by the casual user.
  186.  
  187.         midi/midifile.h - defines some constants for MIDI Files.
  188.  
  189.     include.i - Assembly Languange include files.
  190.  
  191.         midi/midi.i - contains the structure definitions for normal
  192.               usage of the MIDI library and constants
  193.               defined for MIDI status bytes, controllers,
  194.               etc.
  195.  
  196.         midi/midibase.i - defines structures used when examining the
  197.                   inner workings of the MIDI library.  This
  198.                   need not be included by the casual user.
  199.  
  200.     libs - contains "midi.library" and "arp.library".  Copy these to
  201.        your LIBS: directory.
  202.  
  203.        (arp.library is not included in the ARC file as it is
  204.        probably available on the system from which you downloaded
  205.        this file)
  206.  
  207.  
  208. Copyright & Distributions
  209. -------------------------
  210.  
  211. The MIDI Library and related files are Copyright (C) 1987, 1988,
  212. Pregnant Badger Music.    All rights reserved.  The contents of this disk
  213. may be freely distributed.  The MIDI Library and the MIDI Utilties may
  214. be included with commercial products with the following provisos:
  215.  
  216.     1. Pregnant Badger Music should be kept informed of your intent to
  217.        release products that make use of the MIDI Library so that we may
  218.        keep you informed of changes, updates, etc.
  219.  
  220.     2. The above copyright notice should be included somewhere in the
  221.        documentation accompanying any such commercial products.
  222.  
  223.  
  224.     Bill Barton
  225.     Pregnant Badger Music
  226.     1111 El Sur Way
  227.     Sacramento, CA  95864
  228.     (916) 487-9472
  229.  
  230.     Bix:    peabody
  231.     Plink:  peabody
  232.     Delphi: bbarton  (I don't get over there very often)
  233.  
  234.     Member of the International MIDI Association.
  235.  
  236.  
  237. ARP is Copyright (C) 1987, 1988 by Arp Authors
  238.  
  239.     Arp Support
  240.     c/o Microsmiths, Inc
  241.     PO Box 561
  242.     Cambridge, MA 02140
  243.  
  244.  
  245. Basic examples are provided by:
  246.  
  247.     Jim McConkey
  248.     Triangle Audio, Inc.
  249.     P.O. Box 1108
  250.     Sterling, VA 22170
  251.  
  252.     (thanks, Jim)
  253.  
  254.  
  255. Yamaha is tm of Nippon Gakki Co, Ltd.
  256.  
  257.